home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / dru_225.zip / REMOTE.DOC < prev    next >
Text File  |  1989-06-16  |  19KB  |  405 lines
  1.                                                                    
  2.  
  3.           -=-  Remote Utilities v2.25
  4.  
  5.                Copyright (C) 1989  by Jeremy Slade
  6.                All rights resereved
  7.  
  8.                Written by Jeremy Slade of Delta Software Productions
  9.  
  10.  
  11.  
  12.  
  13.      -=- Disclaimer
  14.  
  15.          Although I have taken every precuation I can think of to make
  16.          this program safe to use, I cannot be held responsible for
  17.          any damage that occurs as the result of any use or misuse of
  18.          this program.
  19.  
  20.  
  21.      -=- Overview
  22.  
  23.          Remote Utilities v2.25 is intended to be a utility to allow
  24.          remote users who act as co-SysOps of a BBS system to have a
  25.          controlled-access drop-to-dos replacement. This program can
  26.          be set up to allow certain users access to different commands
  27.          and to even limit what subdirectories can accessed. This is
  28.          accomplished through the use of a control file, which can
  29.          have any name, thus allowing for as many separate control
  30.          files as are necessary.
  31.  
  32.  
  33.      -=- Setup
  34.  
  35.          First of all, the FOSSIL communications driver needs to
  36.          present in memory. Refer to the documentation on your
  37.          particular driver for info on ding this.
  38.  
  39.          Next, you need to have the ability to call the program from
  40.          within your bbs software. Remote Uitlities was mainly de-
  41.          signed to be used with the QuickBBS bbs package written by
  42.          Adam Hudson. To use Remote Utilities with QuickBBS, add a
  43.          type 7 menu entry to which ever menu it is to be called from,
  44.          and use the following line for the data line:
  45.  
  46.                 *C /C REMOTE.EXE <port> *B -A*G
  47.  
  48.          where port is the communications port to be used for
  49.          communications. See below for additional parameters that may
  50.          be used.
  51.  
  52.  
  53.      -=- Operation
  54.  
  55.       - Parameters
  56.  
  57.          When running in remote mode, the first parameter must contain
  58.          the number of the communications port to be used, and the
  59.          second must contain the baud rate. For example:
  60.  
  61.                 REMOTE 2 1200
  62.  
  63.          means to use COM2 at 1200 baud. All other parameters are
  64.          optional.
  65.  
  66.          Parameter      Meaning/Function
  67.          -L             Local Mode. Remote is always assumed unless
  68.                         this parameter is specified. It may be any-
  69.                         where on the command line.
  70.          -A<val>        Specifies use of ANSI/VT100 control codes. If
  71.                         <val> is 0, then these codes are suppresed.
  72.                         Any other value allows these codes.
  73.          -B             This parameter suppresses the use of any color
  74.                         codes. If ANSI/VT100 is turned off, then this
  75.                         has no effect.
  76.          -C<full path>  This parameter is used to specify the location
  77.                         and name of the control file to be used. This
  78.                         file can be used to control access to certain
  79.                         options of the program. See the 'Control File'
  80.                         section below for description on the format
  81.                         of this file. This must be the last paramter
  82.                         on the command line if it is used.
  83.          -D<full path>  This paramter is used to specify the full path
  84.                         to a batch file that is invoked when the Dos
  85.                         Shell command is called. See 'Operation - dOs'
  86.                         for a discussion on the contents of this file.
  87.                         The default is RMTSHELL.BAT in the directory
  88.                         the Remote Utilities was started from.
  89.       *  <Port>         This value has the range of 0..4, and speci-
  90.                         fies the communications port to be used(0
  91.                         means local). Any value out of this range will
  92.                         result in an error, and the program will
  93.                         terminate and exit at errorlevel 1. This must
  94.                         be the fist parameter on the command line
  95.                         whenever it is used.
  96.       *  <Baud>         This value specifies then baud rate to be
  97.                         used. Allowed rates are: 0 (local), 300, 1200,
  98.                         2400, 4800, 9600. Values greater than 9600
  99.                         will result in an error, and the program will
  100.                         terminate and exit at errorlevel 1. This must
  101.                         be the second parameter on the command line
  102.                         whenever it is used.
  103.          <work path>    This parameter specifies the initial work path
  104.                         to start from. If not is specified, or it is
  105.                         invalid, the user will be prompted to enter
  106.                         the work path to be used.
  107.  
  108.  
  109.      -=- Operation (continued)
  110.  
  111.       - Parameters (continued)
  112.  
  113.          If no paramters are given, or there is a fatal error
  114.          detected, the program will print the message 'Invalid
  115.          Parameters' on the local screen, and exit at errorlevel 1.
  116.           If the program terminates normally, it will exit at
  117.          errorlevel 7. If the carrier is drop during remote operation,
  118.          the program will terminate at errorlevel 255.
  119.  
  120.  
  121.          * Required, but only for remote mode.
  122.  
  123.  
  124.  
  125.      -=- Operation (continued)
  126.  
  127.       - Commands
  128.  
  129.        Path - Change Path
  130.  
  131.          This command is used to change the Work Path. Pressing Tab
  132.          will abort any changes. After entering the new work path,
  133.          Remote Utilities will attempt to change to the new path. If
  134.          this attempt is unsuccessful, it will print an error message,
  135.          and then repeat the input process. The work path is the path
  136.          that is used in all directory listings, and is the location
  137.          of the source/object files for all View, Rename, Delete, and
  138.          Copy operations. This is also the path that is made current
  139.          when using the Dos Shell. After the program terminates, the
  140.          original directory is restored (i.e. The directory the
  141.          program was executed from is made current).
  142.  
  143.        List - List Files
  144.  
  145.          This operates the same as a Dos DIR command. After entering
  146.          the filespec (name(s) of files to list), the program will ask
  147.          whether to use the Extended or Normal(default) list. With the
  148.          normal list, files are listed 4 to a line, separated by an
  149.          '|' character. Info displayed is the name, extension, and
  150.          size (in Kilobytes). At the end of the listing, a line will
  151.          be displayed containing the total number of files listed, and
  152.          the total size of these files in Kilobytes. In Extended list,
  153.          files are displayed one to a line with the following info:
  154.          Name, extension, size (in bytes), date (MM-DD-YY), time, and
  155.          attributes. The attributes can be any combo of the following:
  156.          Read Only, Hidden, System, and Archive, or Subdir. After
  157.          listing the files, a line will be printed containing the
  158.          number of files listed and their total size in bytes.
  159.  
  160.        View - View File
  161.  
  162.          This command will display the contents of any file to the
  163.          screen. For local mode, ANSI processing is used. After
  164.          entering the file name (must be in Work Path), the file is
  165.          read and printed to the screen. To abort the display, press
  166.          'S', or press 'P' to pause.
  167.  
  168.        Rename - Rename File
  169.  
  170.          This command first asks for the file to be renamed. It then
  171.          searches the Work Path for the specified file. If it is found
  172.          it then asks for the new name. If the new name is valid (i.e.
  173.          doesn't already exist), then the first file is renamed to the
  174.          second one.
  175.  
  176.        Delete - Delete Files
  177.  
  178.          This command can be used to delete multiple files in the Work
  179.          Path. The program prompts for the filespec (wildcards valid)
  180.